ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Standard functions / Queue, stack, list and array functions / Array functions
  • Operating mode
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Returns an array containing the elements of a source array for which a procedure returns True.
This function can be used:
  • on one-dimensional arrays s,
  • New in version 2024
    about arrays associations.
    AndroidAndroid Widget Not available.
Example
Syntax
<Result> = <Source array>.Filter(<Condition to check>)
<Result>: WLanguage array
Array that contains the elements of the <Source array> for which the <Condition to check> returns True.
<Source array>: WLanguage array
Name of the Array variable to use. This array can be:
  • a one-dimensional array.
  • New in version 2024
    an array association.
    AndroidAndroid Widget Not available.
<Condition to check>: WLanguage procedure
Name of the WLanguage procedure to be executed for each element of the <Source array>. This procedure must return True or False.
This procedure can be:
  • a global or local procedure,
  • an internal procedure.
It is also possible to directly use a lambda procedure.
Remarks

Operating mode

The Procedure is called for each element of the source array by passing the parameter:
  • the array source element,
  • New in version 2024
    the key to the element.
    In the case of a simple array, the key corresponds to the element index. This parameter is optional.
    In the case of an associative array, the key corresponds to the element indexing key..
    AndroidAndroid Widget Not available.
If the procedure returns True, the element from the source array is stored in the <Result> array.

Sequence of functions
You can use array functions in a sequence.
The following functions can be used in a sequence: This sequence can be used as a source for a FOR ALL statement or it can end with one of the following functions: Example:
gnMoyenne = gtabUser.Filtre(cbFiltre).Map(cbTransforme).Mean()
Related Examples:
Filter / Map / Reduce Unit examples (WINDEV): Filter / Map / Reduce
[ + ] This example shows how to use the Filter / Map / Reduce functions.
The Filter / Map / Reduce concept allows performing operations on sets of data in a remarkably concise way.
Filter is used to filter an array of elements in a customized way (with a callback procedure).
Map is used to transform an array of elements, also with a callback procedure.
Reduce is used to aggregate data in a customized way with a callback procedure.
Here, this example is used to calculate the average age of women among the users displayed in the table below.
Component: wd290vm.dll
Minimum version required
  • Version 25
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 04/22/2024

Send a report | Local help